home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / pira151a.zip / SYSOP.DOC < prev   
Text File  |  1987-04-02  |  13KB  |  327 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                    SYSOP DOCUMENTATION FOR DOORS
  11.  
  12.                              for the
  13.  
  14.                       IBM Personal Computer
  15.  
  16.                           Version 15.XX
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                                by
  24.  
  25.                        Bob Westcott
  26.                        7 Dunloggin Drive
  27.                        Merrimack N.H. 03054
  28.                        Voice (603) 424-6977
  29.                        Data  (603) 424-5497
  30.  
  31.                           April 1, 1987
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67. Whats new in this version of Doorware:
  68.  
  69. You CAN NOT have color or music UNLESS you are using the MONITOR!
  70.  
  71. A  NEW  batch file set up which allows you to use the same  batch 
  72. file if you are using 1 or more nodes this is due to a new system 
  73. on the RBBS now passes the node to the doors.
  74. >>>> Your xxxx.BAT file MUST NOT have a RBBS.BAT at the end <<<<
  75.  
  76. The  is  now  a common Sysop.DOC file which is the same  for  all 
  77. Doorware and if some added information is needed for the Doorware 
  78. program it will be in a separate and SHORT file.
  79.  
  80. Sound can now be controlled (on or off).
  81.  
  82. Color and music on most all new programs now allowed (music  will 
  83. be turned off if you shut of sound). 
  84.  
  85. Amount of time left in the doors is now printed on the 25 line of 
  86. the program (M.L.= xx:xx) minutes and seconds
  87.  
  88. You  may make your own file which can have a graphic picture with 
  89. sound (I will supply one with some programs).
  90. Lets  see who can make the best AND pass them around if I  see  a 
  91. good  one I will place it in the files I distribute (If you don't 
  92. mine).
  93.  
  94. Prelog to the Introduction
  95. --------------------------
  96. This  file ONLY tells you how to set up for door program not  how 
  97. to set up your files to operate the doors system.   The doc.  for 
  98. how to setup your files for doors is in the file called BATCH.ARC 
  99. and if you do not have this file you may get it at my RBBS.
  100.  
  101. First thing I must do is to thank Tom Mack and Jon Martin for the 
  102. time,   energy  (and  love)  for the best  BBS  in  the  country.  
  103. Without  there  effort  none of us would be able to  run  such  a 
  104. wonderful piece of software such as the RBBS-PC.
  105.  
  106. 1.1 Introduction
  107. ----------------
  108. Doorware  is  the name I have given the type of software  that  I 
  109. make  to  operate  on the RBBS type of BBS.   I try to  make  the 
  110. software  as error free as possible but "Murphy" is always  there 
  111. so  if  you  run into errors please call via  voice  or  leave  a 
  112. message  on my BBS and I will try to have them fixed on the  next 
  113. version.
  114.  
  115. If  you have any software that you think will make a good door  I 
  116. am  always looking for that type to convert to  Doorware.  To  do 
  117. this  the  code  must be in basic SOURCE.  I do not  release  the 
  118. source code without the authors permission and then only the code 
  119. as  I receive it.  Credit for the software is ALWAYS given to the 
  120. author (if know).
  121.  
  122. Because  it  is very possible to cause a security problem on  the 
  123. RBBS  (people being able to get into your DOS) the door  part  of 
  124. the source will not be made available.  I will help anyone who is 
  125. interested in the way you write software to work on the 'Doors'. 
  126.  
  127. The software is able to handle multi-tasking under Multi-Link and 
  128. Double Dos, but is limited to 9 nodes.
  129.  
  130. 1.2 Update Conventions
  131. ----------------------
  132. Since  this software is very closely tied to the RBBS software  I 
  133. will  update it when new version/levels of the RBBS are released.  
  134. The  version  level of Doorware will be the same as  the  version 
  135. level that it will work with of the RBBS.  If the new version  of 
  136. RBBS  does not require a new version of Doorware there may or may 
  137. not be a new version of Doorware.
  138.  
  139.  
  140. The latest version of the Doorware will always be on my RBBS  and 
  141. other selected RBBS.
  142.  
  143. 2.1 Required files
  144. ------------------
  145. You must have a batch file that you are running your RBBS from. 
  146.  
  147. The purpose of the files are as follows:
  148.  1. filename.EXE    The operational software.
  149.  2. filename.DOC    The  file  which informs the player who what                      
  150.                     when and where about this program.
  151.  3. filename.SCR    This  is  the  daily score  board, but it is                    
  152.                     also    the    file    that    holds    your  
  153.                     system requirements.   Not all programs  use 
  154.                     the score part of this file
  155.  4. filename1.SCR   This is the monthly score board.  Not always 
  156.                     used but always created.
  157.  5. filename.BAT    The   batch   file  that  gets  you  to  the 
  158.                     doorware from the RBBS.
  159.                     DO NOT USE THE SAME FILENAME AS THE DOORWARE
  160.                     NAME. THIS WILL CAUSE A PROBLEM!!!
  161.  5. SYSOP.DOC       This file.
  162.  6. PRELOG.xxx      The  same as  on the RBBS it allows  you  to 
  163.                     place notices on the system.
  164.                     xxx= the  1st  three letter/numbers  of  the 
  165.                     program.
  166.  7.filenameG.DOR    This file is not required but will allow you 
  167.                     to make a graphic picture with sound.
  168.  
  169.  
  170.  
  171.  
  172. ********** NOTE **********
  173. If  you  are going to use this software with the Door monitor  do 
  174. NOT  use the batch files as stated in this record.  Use only  the 
  175. batch files as stated in the monitor SYSOP.DOC.
  176.  
  177. 2.0 Setup
  178. ---------
  179. Because this software reads information from the RBBS files it is 
  180. very important that the supplied files MUST be placed on the same 
  181. drive that the RBBS-PC.DEF,  RBBS1PC.DEF,  RBBS2PC.DEF  etc.  are 
  182. located.
  183.  
  184. The port that is use, the number of data bits, RBBS name, and the 
  185. baud  rate is taken from the RBBS files and used in the  Doorware 
  186. program without any need for you to insert them in a file.
  187.  
  188. You  must make the changes you want on following  information  in 
  189. the 1st 8 fields of the filename.SCR file:
  190.  
  191.  1.  Field #1 The   number of times the  user may  sign  on  to      
  192.               filename each day. (This does NOT apply to SYSOP he 
  193.               may sign  on as many times as he wishes)
  194.  2.  Field #2 The foregound color.
  195.  3.  Field #3 The background color.
  196.  4.  Field #4 The border color.
  197.  5.  Field #5 The  number  of minutes a player is allowed without              
  198.               making a move.
  199.  6.  Field #6 The total number of minutes allowed on this door.
  200.  7.  Field #7 This  field  determines  if you are going to use a     
  201.               common file for all games or a single file for each 
  202.               game.
  203.               See ** for more info about this.
  204.  8.   Field  #8 This field determines if SYSOP score will be used 
  205.              and if there will be sound as follows.
  206.               0  Sysop's score posted, No sound. 
  207.               1  Sysop's score not posted, No sound. 
  208.               2  Sysop's score posted, With sound.
  209.               3  Sysop's score not posted, With sound.
  210.  
  211. **  This  field is used as follows if set to '0' it means a  file 
  212. called  filename.DAY will be created and will list all the  users 
  213. that  has signed on THAT day to THAT program and will be used  by 
  214. field  #1 to determine how many times a user has signed  on  THAT 
  215. day.
  216. If  this field is set to a '1' then a file called COMMON.DAY will 
  217. be created and will have all the users that have signed on to any 
  218. program that has this field set to '1' to be logged.
  219. Example:
  220. You are running 3 games, GAME1.EXE, GAME2.EXE, and GAME3.EXE.
  221. You  have field #6 set to '1' on all programs and field #1 set to 
  222. '2' in all programs. The user will only be able to sign on to any 
  223. of the games 2 times (total) each day.
  224. If all 3 programs have field #6 set to '0' then the user may sign 
  225. on to EACH program 2 times each day.
  226. Beware  this fields may be mixed and will act as listed  and  mix 
  227. things up quite well, SO keep it as simple as possible.
  228. Remember this feature will only be true if the door software  you 
  229. are  using will allow this,  all my software EXCEPT CHESSDOR will 
  230. have this feature.
  231.  
  232. The filename.SCR file will create itself if it can not find  one. 
  233. It will set the all starting scores to 0. If you wish to start at 
  234. any other score you can use EDLIN to change them, but remember to 
  235. change  them EACH month as they will be reset to 0 with the first 
  236. user each month.  DO NOT TRY TO CREATE THIS YOURSELF AS IT CAN BE 
  237. MESSED UP AND CAUSE ERRORS.
  238.  
  239. The  filename1.SCR file is very simple and will create itself  if 
  240. one can not be found.
  241. This files holds the monthly champ information,  but will NOT  be 
  242. outputed until the first monthly champ is created.
  243. The  last  entry of the filename.BAT is the file  that  the  RBBS 
  244. calls to bring up the door program. 
  245.  
  246. The following will work for both tasking and NON-tasking systems.
  247. -----------------------------------------------------------------
  248.  
  249.  (The filename.BAT file )
  250.  
  251.   WATCHDG1 OFF                       To allow around program to 
  252.                                      monitor line (a must!!)
  253.   filename %1                        Call the door program.
  254.  
  255. The door menu file must have the filename in capitals.
  256.  
  257.  
  258. Do  NOT remove the 'WATCHDGx ON' call from the RBBS.BAT files  as 
  259. they  are needed when you go to your DOS from remote (7 from  the 
  260. main menu).
  261.  
  262. You may now use the same door menu file for the nodes as RBBS now 
  263. passes the node information to the batch files.
  264.  
  265. 2.3 Running the Doorware program
  266. --------------------------------
  267. After  completing  the  setup as stated above  insure  that  when 
  268. running the CONFIG file for the RBBS that you have the doors open 
  269. and  allow  the correct access level users to use the doors  that 
  270. you want. Also insure that the RBBS answers on ring 1 or higher.
  271.  
  272. That  is all that is needed to make this work in remote.   To run 
  273. the  program in local you must sign on the RBBS at your  keyboard 
  274. (remember  what node if you are multi tasking) and then when  the 
  275. Main menu is displayed sign off. Then break out of the batch loop 
  276. and  enter  filename  (If you  are  running  NON-Multi  Tasking), 
  277. filename 1 (If you are on node 1), filename 2 (If you are on node 
  278. 2).   This  will  bring up the around game in local and  you  can 
  279. run/play in the local mode which functions the same as remote.
  280.  
  281. While  watching  the screen when a remote user is on a  door  you 
  282. will  see  the  users  name is in the lower left  corner  of  the 
  283. screen,  in  the  middle will be the version #  of  the  Doorware 
  284. program that you are using and the node that is operating, and on 
  285. the  right side you will have displayed the time the user started 
  286. using the the program when the program is first loaded (15:23:47) 
  287. then  it will display the number of minutes the user has left  in 
  288. the doors (M.L.= 23:42). Also when the remote users screen does a 
  289. clear  yours  will NOT it will just  print  (CLEAR  SCREEN).  The 
  290. purpose  of this is to keep the 25 line on your screen and  clear 
  291. to remote users screen.
  292.  
  293. The  following  two paragraphs are only true when using NO  multi 
  294. tasking or when using Double DOS.
  295.  
  296. Pressing  the  function  #10 key while a remote user  is  on  the 
  297. system will place you in the chat mode and allow you to talk with 
  298. the player.   To return the player to the game you must press the 
  299. ESC  key this is the same procedure as on the RBBS.   The  player 
  300. does NOT have a function on his menu to call you.
  301.  
  302. Pressing the function #8 key allows you to reduce or increase the 
  303. time the player is allowed to stay on on this one time.  You will 
  304. get a prompt for the number of minutes you wish to let them  have 
  305. then  you  enter  a number and press enter.   This will  cause  a 
  306. message  to be place on the screen to inform the player that  the 
  307. amount of around has changed.
  308.  
  309. So you got a problem!!!  
  310. -----------------------
  311. If you have a problem installing this program or it bombs on  you 
  312. look for the following data:
  313.  
  314. 1.  A printout displayed on your screen telling you the problem.
  315. 2.  Look  on  the disk that holds the main DOR program for a file    
  316. named  ERRORS.DOR  and print it.  This info should  be  forwarded    
  317. to me for debuging and correction.
  318.  
  319. In most cases (all I hope) one of the 2 above indications  should 
  320. happen  when a error occurs.  All errors should be reported to be 
  321. via phone or RBBS if possible for correction.
  322.  
  323. Good luck and enjoy this software.
  324.  
  325.                                  Bob...
  326.                                                                  
  327.